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4. TUTORIAL—TEXT EDITOR 
INTRODUCTION 


Almost all text input on the UNIX operating system is done with the standard text editor ed(1). This is a 
tutorial guide to help beginners get started with text editing. 


Although this guide does not cover everything about the UNIX operating system, it does discuss enough for 
most user’s day-to-day needs. This includes printing, appending, changing, deleting, moving, and inserting en- 
tire lines of text; reading and writing files; context searching and line addressing; substituting; global changing; 
and using some special characters for easier editing. 


Throughout this section, each reference of the form name(1M), name(7), or name(8) refers to entries in 
the UNIX System Administrator’s Manual. All other references to entries of the form name(N), where “N” 
is a number (1 through 6) possibly followed by a letter, refer to entry name in section N of the UNIX System 
User’s Manual. 


GENERAL 


The ed program is a “text editor”, that is, an interactive program for creating and modifying “text”, using 
directions (commands) provided by a user at a terminal. The text is often a document like this one or perhaps 
data for a program. 


This tutorial is meant to simplify learning ed. The recommended way to learn ed is to read this document, 
simultaneously using ed to follow the examples, then to read the description in Section 1 of the UNIX System 
User’s Manual, all the while experimenting with ed. (Solicitation of advice from experienced UNIX operating 
system users is also useful.) 


Do the exercises! The exercises illustrate techniques not completely discussed in the actual text. A summary 
at the end of this section summarizes the commands. 


A. Disclaimer 


This is a tutorial introduction and guide only. For this reason, no attempt is made to cover more than a 
part of the facilities that ed offers (although this fraction includes the most useful and frequently used facili- 
ties). Also, there is not enough space to explain the basic UNIX operating system procedures. It is assumed that 
the user knowshow to log on to the UNIX operating system and has at least a vague understanding of a UNIX 
operating system file. For more on the UNIX operating system facilities, refer to the previous section of this 
volume titled, “Basics for Beginners”. 


The user must also know what character to type as the end-of-line character on the user’s particular termi- 
nal. This character is the RETURN or newline character (key) on most terminals. Hereafter reference to the 
end-of-line character, whatever it is, will be referred to as RETURN. 


GETTING STARTED 


Assume that the user has logged in to a UNIX operating system and it has just printed the prompt 
character, usually a 


$ 


The easiest way to invoke ed is to type: 


ed (followed by a RETURN) 
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You (the user) are now ready to go. The ed program is waiting to be told what to do. 


A. Creating Text—The Append Command “‘a”’ 


As your first problem, suppose some text is to be created starting from scratch. Perhaps the very first draft 
of a document or paper is to be entered; clearly, it will have to start somewhere and undergo modifications 
(editing) later. This part will describe how to enter some text to get a file of text started. How to make changes 
and corrections to the text is described later. 


When ed is first invoked, it is rather like working with a blank piece of paper (the file)—there is no text 
or information present on the paper (in the file). The text must be supplied by the person using ed; it is usually 
done by typing in the text or by reading it into ed from a file. We will start by typing in some text and return 
shortly to how to read files. 


First a bit of terminology. In ed jargon, the text being worked on is said to be “kept in a buffer.” Think 
of the buffer as a work space, if desired, or simply as the information that is to be edited. In effect the buffer 
is like the piece of paper on which we will write things, then change some of them, and finally file the whole 
thing away for another day. 


The user tells ed what to do to the text by typing instructions called “commands.” Most commands consist 
of a single lowercase letter. Each command is typed on a separate line. (Sometimes the command is preceded 
by information about the line or lines of text to be affected—these will be described below.) The ed text editor 
makes no response to most commands—there is no prompting or response messages like “ready”. (This silence 
is preferred by experienced users, but sometimes is a hangup for new users.) 


The first command is append, written as the letter 


a 


all by itself. It means “append (or add) text lines to the buffer, as I type them in.” Appending is rather like writ- 
ing fresh material on a piece of paper. So to enter lines of text into the buffer, just type an 


a 
followed by a RETURN, and by the lines of text desired, like this: 


a 

Now is the time 

for all good men 

to come to the aid of their party. ne 


The only way to stop appending is to type a line that contains only a period. The “.” is used to tell ed that the 
appending is finished. (Even experienced users forget to terminate appending with a “.” sometimes. If ed seems 


to be ignoring your entries, type an extra line with just the “.” on it. You may then find you have added some 
garbage lines to your text, which you will have to take out later.) 


After the append command has been done, the buffer will contain the following three lines: 


Now is the time & 


for all good men 
to come to the aid of their party. 


The a and the “.” are not there because they are not text. & 
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To add more text to what already exits, just issue another a command and continue typing. 
B. Error Messages (7?) 


If at any time the user makes an error in the commands typed into ed, the text editor will tell the user by 
typing the following: 


? 


This is about as cryptic as it can be, but with practice, the user can usually figure out the goof. The user can 
get a brief explanation of the error by typing 


h 
and maybe get some help. 
C. Writing Text File—The Write Command “w” 


It is likely that you will want to save your text for later use. To write out the contents of the buffer onto 
a file, use the write command 


WwW 


followed by the file name to write on. This will copy the buffer’s contents onto the specified file (destroying any 
previous information on the file). To save (write) the text in a file named junk, for example, type: 


w junk 


Leave a space between w and the file name. The ed program will respond by printing the number of characters 
it wrote out. In this case, ed would respond with: 


68 


(Remember that blanks and the return character at the end of each line are included in the character count.) 
Writing a file just makes a copy of the text—the buffer’s contents are not disturbed, so the user can go on adding 
lines to it. This is an important point. The ed program at all times works on a copy of a file, not the file itself. 
No change in the contents of a file takes place until you give a w command. (Writing out the text onto a file 
from time to time as it is being created is a good idea. If the system crashes or if the user makes some horrible 
mistake, all the text in the buffer will be lost but any text that was written onto a file is relatively safe.) 


D. Leaving ed—The Quit Command “q’”’ 


To terminate a session with ed, first save your text by writing it onto a file using the w (write) command, 
and then type the q (quit) command: 


q 


The system will respond with the prompt character: 


$ 


At this point your buffer vanishes, with all its text, which is why the user would want to write before quitting. 
Actually ed will print the character 


rf 
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if the user tries to quit without writing. At this point, the user writes if desired; if not, another q will get you 
out regardless and will not save the text in the buffer. 


EXERCISES—TRY THEM! 


EXERCISE 1 


Enter ed and create some text using the append command a 


a 
Ber Fost eae 


Note that no system prompt appears while in the text editor. Do not forget to write the text into memory with 
the write command w. Write it into memory using the w command. Then leave ed with the q command and 
print the file to see that everything worked. To print a file, enter 


pr filename 
or 
cat filename 


in response to the prompt character ($). Try both. 
A. Reading Text File—The Edit Command “‘e’’ 


A common way to get text into the buffer is to read it from another file in the file system. This is what you 
do to edit text that you saved with the w command in a previous session. The edit command 


e 


retrives the entire contents of a file into the buffer. So if the user had saved the three lines “Now is the time”, 
etc., with a w command in an earlier session, the edit command 


e junk 
would place the entire contents of the file junk into the buffer and respond with a number 
68 


which is the number of characters in the file junk. If anything was already in the buffer, it is deleted first. 


If the e command is used to read a file into the buffer, then the user does not need to use a file name after 
a subsequent w command; ed remembers the last file name used in an e command, and w will write on this 
file. Thus a good practice to follow is: 


ed 
e filename 
[editing session] 


w 
q 
This way, the user can simply enter w from time to time and be secure in the knowledge that if the user got 


the file name right at the beginning, the user is writing into the proper file each time. Note that after each edit 
command e or each write command w the number of characters is returned by ed. 
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The user can find out at any time what file name ed is remembering by typing the file command f. In this 
example, if you typed : 
f 
ed would reply 
junk 
B. Reading Text File—The Read Command “'r’”’ 


Sometimes you want to read a file into the buffer without destroying anything that is already in the buffer. 
This is done by the read command r. The command 


r junk 


will read the file junk into the buffer. The command appends the file specified to the end of whatever file is 
already in the buffer. So if you do a read after an edit command such as 


e junk 
r junk 


the buffer will contain two copies of the text (six lines) as follows: 


Now is the time 
for all good men 
to come to the aid of their party. 
Now is the time 
for all good men 
to come to the aid of their party. 


Like the w and e commands, r prints the number of characters read in after the reading operation is complete. 
Generally speaking, r is much less used than e. 


The read command r may also be used to read a file external to the buffer into the file in the buffer. While 
in ed and at the current (or dot) line, enter the command 


r filename 


and filename will be read into the file (already in the buffer) immediately after the current line. None of the 
file in the buffer is destroyed, rather the external file filename has been read into and been combined with the 
file already in the buffer. The file that was read remains in filename also. You only copied it. Notice the differ- 
ence between “r” and “.r”. 


EXERCISE 2 

Experiment with the e command—try reading and printing various files. The user may get an error ?name 
where nameis the name of a file. This means that the file does not exist. Some typical causes of getting an empty 
file are spelling the file name wrong or perhaps trying to read or write a particular file which your permissions 


will not allow. Try alternately reading and appending to see that they work similarly. Verify that 


ed filename 
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is exactly equivalent to 


ed 

e filename 
What does 

f filename 
do? 


A. Printing Buffer Contents—The Print Command “p”’ 


To print or list the contents of the buffer (or parts of it) on the terminal, use the print command p. This 
is done as follows. Specify the line numbers where printing is to begin and end. These numbers have a comma 
between the beginning number and the ending number, i.e., “beginning line number, ending line number p”. 
Thus to print the first ten lines of the contents of any buffer (i.e., lines 1 through 10), type: 


1,10p (Prints lines 1 through 10) 
The ed will respond by printing the specified starting line (1) through the specified ending line (10). 
Suppose it is desirable to print all the lines in the buffer. You could use “1,30p” as above if it is known there 
were exactly 30 lines in the buffer. But in general, it is not known how many lines there are, so what can be 


used for the ending line number? The ed program provides a shorthand symbol for “line number of the last 
line in the buffer”—the dollar sign $. To print all the lines in the buffer, use it this way: 


1,$p (Prints all lines in buffer) 
or 
»p (Prints all lines in buffer also) 


This will print all the lines in the buffer (line 1 through the last line). The “1,$p” can be abbreviated “,p”. To 
stop the printing before the last line is printed, push the DEL key or the DELETE (or equivalent) key on the 
terminal. The ed program will respond 


? 

and wait for the next input command. 

To print the last line of the buffer, use 

$,$p 

but ed lets you abbreviate this to 
$p 

Any single line can be printed by typing the line number followed by a p. Thus 
Ip 

produces the response 
Now is the time 


which is the first line of the buffer. 
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In fact, ed lets you abbreviate even further. You can print any single line by typing just the line number— 
no need to type the letter p. So by entering 
$ 
ed will print the last line of the buffer. Entering a single line number will print that line only. 
It is also possible to use $ in combinations like 
$—5,$p 


which prints the last five lines of the buffer. This helps to determine the end of the contents of the buffer when 
more is to be entered. 


EXERCISE 3 
Create some text using the a command and experiment with the p command. The user will find, for example, 
that line 0 or a line beyond the end (last line) of the buffer can not be printed. Also attempts to print a buffer 
in reverse order by entering 
3,lp 
will not work. 
A. The Current Line “.” or Dot 
Suppose the buffer still contains the six lines of text (as in Exercise 1), and the following was entered 
1,3p 
and ed has printed the three lines. Try typing just 
p (no line numbers) 
This will print 
to come to the aid of their party. 


which is the third line of the buffer. In fact it is the last (most recent) line that anything was done to. (The line 
just printed!) The p command can be repeated without line numbers, and it will continue to print line 3. 


The reason is that ed maintains a record of the last line that anything was done to (in this case, line 3, which 
was just printed) so that it can be used instead of an explicit line number. This most recent line is referred to 
by the shorthand symbol 


(Pronounced “dot”). 


Dot is a line number in the same way that $ is. Dot means exactly “the current line”, or loosely, “the line some- 
thing was done to most recently.” The dot can be used in several ways—one possibility is to enter: 


8) 


This will print all the lines from (including) the current line to the end (last line) of the buffer. In our example 
these are lines 3 through 6. 


Page 41 


USER'S GUIDE ISSUE 1 6/82 


Some commands change the value of dot, while others do not. The print command p sets dot to the number 
of the last line printed; the last command, will set both “.” and $ to the last line in the buffer (line 6). 


Dot is most useful when used in combinations like this one: 
+1 (or equivalently, .+1p) 
This means “print the next line” and is a handy way to step slowly through a buffer. The user can also enter 
| (or lp) 


which means “print the line before the current line.” This enables stepping through the buffer backwards if 
desired. Another useful one is something like 


SN Hitt 
which prints the previous three lines. 
Do not forget that all of these change the value of dot. The user can find out what dot is at any time by typing 
= (dot line number is ?) 
The ed program will respond by printing the value (line number) of dot. 

Let us summarize some things about the p command and dot. Essentially, p can be preceded by 0, 1, or 2 
line numbers (for our example). If there is no line number given, it prints the “current line”, the line that dot 
refers to. If there is one line number given (with or without the letter p it prints that line (and dot is set there); 
and if there are two line numbers (separated by a comma), it prints all the lines in that range (from the first 
number to the last number, and sets dot to the last line printed). If two line numbers are specified, the first 


can not be bigger than the second (refer to the beginning of “EXERCISE 3”.) 


Typing a single RETURN will cause printing of the next line—it is equivalent to: 


.+1p 
Try it. Typing a * is equivalent to typing the minus —. It can be used in multiples, as *~*~* , which will move 
the current line or dot line backwards three lines from the current line. The “—” or the “*” can be considered 


equivalent to “—1p” since either moves the dot back one line. 
B. Deleting Lines—The Delete Command “‘d’”’ 
Suppose three extra lines in the buffer are not needed. This is done by the delete command: 
d 


Except that d deletes lines instead of printing them, its action is similar to that of the print command p. The 
lines to be deleted are specified for d exactly as they are for p as follows: 


starting line, ending line d 
Thus the command 
4,$d 
deletes lines 4 through the end. There are now three lines left, that can be checked by using: 


1,$p 
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And notice that $ now is line 3! Dot is set to the next line after the last line deleted, unless the last line deleted 
is the last line in the buffer. In that case, dot is set to $. The delete command d and the print command p may 
be used together thus 

dp 
which deletes the current line, prints the following line, and sets dot to the line printed. 


EXERCISE 4 


The user should experiment with a, e, r, w, p, and d until you become familiar with their use. While experi- 
menting also use “dot”, $, and line numbers to understand their use. 


When feeling adventurous, try using line numbers with a, r, and ¢ as well. The user will find that a will 
append lines after the line number that you specify (rather than after dot); that r reads a file in after the line 
number you specify (not necessarily at the end of the buffer); and that w will write out exactly the lines speci- 
fied, not necessarily the whole buffer. These variations are sometimes handy. For instance, a file can be inserted 
at the beginning of a buffer by entering: 
Or filename 

Lines can be entered at the beginning of the buffer by using: 
0a 
ORG 

Notice that “.w” is very different from 
w 

A. Modifying Text—The Substitute Command ‘'s’’ 

We are now ready to try one of the most important of all commands—the substitute command 


$ 


This is the command that is used to change individual words or letters within a line or group of lines. The substi- 
tute command is used for correcting spelling mistakes and typing errors. 


Suppose that, because of a typing error, line 1 says 
Now is th time 
notice the e has been left off. The s command can be used to fix this as follows: 
1s/th/the/ 


This says: in line 1, substitute for the characters th the characters the. To verify that it works, ed will not print 
the result automatically, enter 


p 
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and get 
Now is the time 


which is what is desired. Notice that dot must have been set to the line where the substitution took place, since 
the p command printed that line. Dot is always set this way with the s command. 


The general way to use the substitute command is 
starting-line, ending-line s/change this/to this/ 

Whatever string of characters is between the first pair of slashes is replaced by whatever is between the second 
pair, in all the lines between starting-line and ending-line. Only the first occurrence on each line is changed 
however. If e every occurrence is to be changed, see “EXERCISE 5”. The rules for line numbers are the same as 
those for the print command p except that dot is set to the last line changed. (But there is a trap for the unwary: 
if no substitution took place, dot is not changed. This causes an error response ? as a warning.) 

Thus the following can be entered 


1,$8/speling/spelling/ 


to correct the first spelling mistake (speling in this case) on each line in the text. (This is useful for people who 
are consistent misspellers!) 


If no line numbers are given, the s command assumes we mean “make the substitution on line dot”, so it 
changes things only on the current line. This leads to the very common sequence 


s/something/something else/p 
which makes some correction on the current line and then prints it (current line) to make sure it worked out 
right. If it did not, you can try again. (Notice that there is a p on the same line as the s command. With few 
exceptions, p can follow any command; no other multicommand lines are legal.) 
It is also legal to say 


8/....// 


which means change the first string of characters (....) to nothing, i.e., remove them. This is useful for deleting 
extra words in a line or removing extra letters from words. For instance, if the buffer contained 


Nowxx is the time 
this can be corrected by entering 
s/xx//p 

to get 
Now is the time 


Notice that // (two adjacent slashes) means “no characters”, not a blank. There is a difference! (See “Context 
Searching” under “EXERCISE 5” for another meaning of “//”. 
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EXERCISE 5 


Experiment with the substitute command. See what happens if you substitute for some word on a line with 
several occurrences of that word. For example, enter 


a 
the other side of the coin 


s/the/on the/p 
which results in the following: 
on the other side of the coin 


A substitute command changes only the first occurrence of the first string. All occurrences can be changed 
by adding a g (for “global”) command to the s command, like this: 


Try other characters instead of slashes to delimit the two sets of characters in the s command—anything should 
work except blanks or tabs. 


If strange results are produced by inputting 
chee OS Gees Coe 
read the part under “Special Characters” in this section. 
A. Context Searching “‘/...../" 


When the substitute command is mastered, move on to another highly important feature of ed(1)—context 
searching. 


Suppose the original three lines of text in the buffer is as follows: 


Now is the time 
for all good men 
to come to the aid of their party. 


Suppose the word their is to be changed to the. How is the line that contains their located? With only three 
lines in the buffer, it is pretty easy to keep track of what line the word their is on. But if the buffer contained 
several hundred lines and you had been making changes, deleting and rearranging lines, etc., you would no lon- 
ger really know what this line number would be. Context searching is simply a method of specifying the desired 
line, regardless of what its number is, by specifying some context (unique text) on it. 


The way to say “search for a line that contains this particular string of characters” or “unique text” is to 
type: 


/string of characters to find/ 
For example, the ed expression 
/their/ 


is a context search which is sufficient to find the desired line—it will locate the next occurrence of the characters 
between slashes “their”. It also sets dot to that line and prints that line for verification: 


to come to the aid of their party. 
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“Next occurrence” means that ed starts looking for the string at line “+1” and searches to the end of the buffer, 
then continues at line 1 and searches to line dot. That is, the search “wraps around” from $ to 1. It scans all 
the lines in the buffer until it either finds the desired line or gets back to dot again. If the given string of charac- 
ters can not be found in any line, ed types the error message 


? 
Otherwise, it prints the line it found. 
The search for the desired line and the substitution can be done together, like this 
/their/s/their/the/p 
which will yield 
to come to the aid of the party. 


There were three parts to that last command: context search for the desired line, make the substitution, and 
print the line. 


The expression “/their/” is a context search expression. In the simplest form, all context search expressions 
are like this—a string of characters surrounded by slashes. Context searches are interchangeable with line num- 
bers, so they can be used by themselves to find and print a desired line or as line numbers for some other com- 
mand, like s. They were used both ways in the examples above. 


Suppose the buffer contains the three familiar lines 


Now is the time 
for all good men 
to come to the aid of their party. 


Then the ed line numbers 


/Now/+1 
/good/ 
/party/—1 


are all context search expressions, and they all refer to the same line (line 2). To make a change in line 2, enter 


/Now/+1s/good/bad/ 
or 
/good/s/good/bad/ 
or 
/party/—1s/good/bad/ 


The choice is dictated only by convenience. All three lines could be printed by entering 
/Now/,/party/p 
or 


/Now/,/Now/+2p 


or by any number of similar combinations. The first one of these might be better if you do not know how many 
lines are involved. (Of course, if there were only three lines in the buffer, a convenient method of printing would 
be 


1,$p 
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but not if there were several hundred.) 


The basic rule is: a context search expression is the same as a line number, so it can be used wherever a 
line number is needed. 


EXERCISE 6 


Experiment with context searching. Try a body of text with several occurrences of the same string of charac- 
ters and scan through it using the same context search. 


Try using context searches as line numbers for the substitute, print, and delete commands. They can also 
be used with r, w, and a. 


Try context searching using “?text?” instead of “/text/”. This scans lines in the buffer in reverse order 
rather than normal (forward order). This is sometimes useful if you go too far while looking for some string 
of characters—it is an easy way to back up. 

If funny results are obtained with any of the characters 

serge es Uae ae 
read the part in this section on “Special Characters”. 


The ed program provides a short method for repeating a context search for the same string. For example, 
the ed line number 


/string/ 


will find the next occurrence of “string”. It often happens that this is not the desired line, so the search must 
be repeated. This can be done by typing merely: 


// 


This short method stands for “the most recently (last) used context search expression”. It can also be used as 
the first string of the substitute command, as in 


/string]/s//string2/ 
which will find the next occurrence of string 1 and replace it by string2. This can save a lot of typing. Similarly 
2? 
means “scan backwards for the same expression.” 
A. Change and Insert Commands “‘c’” and “i” 
This section discusses the change command 
ic 


which is used to change the current line or to replace the current line with a group of one or more lines, and 
the insert command 


i 
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which is used for inserting a group of one or more lines immediately before the current line. 
“Change”, written as 
c 


is used to replace a number of lines with different lines, which are typed in at the terminal. For example, to 
change the first line (.+1) through the last line ($) of a file to something else, type 


TeLhe 

..type the lines of text you want here... 
The lines typed between the ¢ command and the ‘” (dot) command will take the place of the original lines be- 
tween start line and end line. This is most useful in replacing a line or several lines which have errors. 

If only one line is specified in the ¢ command, then just that line is replaced. (You can type in as many re- 
placement lines as you like.) Notice the use of *” (dot) to end the input—this works just like the ‘” (dot) in the 
a command and must appear by itself at the beginning of newline. If no line number is given, line dot is replaced. 
The value of dot is set to the last line you typed in. 

“Insert” is similar to append—for instance 

/string/i 


..type the lines to be inserted here... 


will insert the given text before the next line that contains “string”. The text between i and the “’ (dot) is in- 
serted before the specified line. If no line number is specified, the dot line is used. Dot is set to the last line insert- 
ed. 
EXERCISE 7 
“Change” is rather like a combination of delete followed by insert. Experiment to verify that 
starting-line,ending-line d 
i 
TUR. 
is almost the same as 
starting-line,ending-line c 
Ue K Ess 


These are not precisely the same if the last line ($) gets deleted. Check this out. What is dot? 


Experiment with the append command a and the insert command i to see that they are similar but not the 
same. You will observe that 


line-number a 
... text... 
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appends after the given line, while 
line-number i 


acbOXb.e. 


inserts before it. Observe that if no line number is given, i inserts before line dot, a appends after line dot, and 
c changes line dot. 


A. Moving Text Around—The Move Command “‘m” 

The move command m is used for cutting and pasting—it allows a group of lines to be moved from one place 
to another in the buffer. Suppose the first three lines of the buffer is to be placed at the end of the buffer instead 
of at the beginning. This could be performed by entering: 

1,3w temp 
$r temp 
1,3d 
(Do you see why?) This method will work, but it is a lot easier using the m command as follows: 
1,3m$ 
The general case is: 


starting-line,ending-line m after this line 


Notice that there is a third line to be specified—the line after which the other lines are to be moved. Of course, 
the lines to be moved can be specified by context searches; if you had 


First paragraph 


end of first paragraph. 
Second paragraph 


oad of second paragraph. 
the two paragraphs could be reversed like this: 

/Second/,/end of second/m/First/—1 
Notice the “—1”—the moved text goes after the line mentioned. Dot gets set to the last line moved. 
THE GLOBAL COMMANDS 


The two global commands are g and v. The global command g is used to execute one or more ed commands 
on all those lines in the buffer that match some specified string. For example 


g/peling/p 


prints all lines that contain “peling”. More usefully, 


g/peling/s//pelling/gp 
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makes the substitution everywhere on the line, then prints each corrected line. Compare this to ss 
1,$s/peling/pelling/gp 


which only prints the last line substituted. Another subtle difference is that the g command does not give a 
?—if “peling” is not found where the s command will. 


There may be several commands including a, ¢c, i, r, w, but not g; in that case, every line except the last 
must end with a backslash “\’. 


g/xxx/—1s/abe/def/ \ 
.+2s/ghi/jkl/\ 
ap 


makes changes in the lines before and after each line that contains “xxx”, then prints all three lines. Ea 


The v command is the same as g except that the commands are executed on every line that does not match 
the string following v. The following input 


v/ /d 
deletes every line that does not contain a blank. 
SPECIAL CHARACTERS 
You may have noticed that things just do not work right when you used some characters like ., *, $, and 
others in context searches and in the s command. The reason is rather complex, although the cure is simple. 


Basically, ed treats these characters as special, with special meanings. For instance, in a context search or the S 
first string of the substitute command only, 


/x.y/ 
means “a line with an x, any character, and a y”, not just “a line with an x, a period, and a y.” 
The following is a complete list of the special characters that can cause trouble: 
ee ee ee 


Warning: The backslashcharacter “\” is special to “ed”. For safety’s sake, avoid it where 
possible. 


If you have to use one of the special characters in a substitute command, you can turn off its magic meaning ey 
temporarily by preceding it with the backslash. Thus 


s/\\\ .\*/backslash dot star/ 


will change “\.*” into “backslash dot star”. 


ear? 


Here is a brief synopsis of the other special characters. First, the circumflex 
of a line. Thus 


signifies the beginning 


/*string/ 
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finds “string” only if it is at the beginning of a line. It will find 
string 

but not 
the string... 

The dollar-sign “$” is just the opposite of the circumflex; it means the end of a line. The input 
/string$/ 

will only find an occurrence of “string” at the end of some line. This implies, of course, that 
/*string$/ 

will find only a line that contains just “string” and 
hs Fh 

finds a line containing exactly one character. 

The character “.”, as we mentioned above, matches anything. For example, the input 

/x.y/ 

matches any of the following: 
x+y 
ey, 


xy 
x.y 


oh? 


This is useful in conjunction with which is a repetition character. The “a*” is a shorthand input for “any 
number of a’s” therefore “.*” matches any number of anythings. For example input 


s/.*/stuff/ 
which changes an entire line, or 
af Fy 7 


which deletes all characters in the line up to and including the last comma. (Since “.*” finds the longest possible 
match, this goes up to the last comma.) 


The “[” is used with the “]” to form character classes; for example, 
/(0123456789]/ 


matches any single digit—any one of the characters inside the braces will cause a match. This can be abbrevi- 
ated to 


[0-9] 


Finally, the “&” is another shorthand character—it is used only on the right-hand part of a substitute com- 
mand where it means “whatever was matched on the left-hand side”. It is used to save typing. Suppose the cur- 
rent line contained 


Now is the time 
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and you wanted to put parentheses around it. One tedious method is just to retype the line. Another method & 
is to enter : 


s/*/(/ 
3/$/)/ 


using your knowledge of “*” and “$”. But the easiest way uses the “&” as follows: & 
8/.*/(&)/ 


This says “match the whole line and replace it by itself surrounded by parentheses.” The “&” can be used several 
times in a line; consider using 


3/.*/&? &!!/ 

to produce a) 
Now is the time? Now is the time!! 

You do not have to match the whole line, of course. If the buffer contains 

the end of the world 

you could type 
/world/s//& is at hand/ 

to produce | SB 
the end of the world is at hand 

Observe this expression carefully, for it illustrates how to take advantage of ed to save typing. The string 

“/world/” found the desired line; the shorthand “//” found the same word in the line; and the “&” saves you 

from typing it again. 


The “&” is a special character only within the replacement text of a substitute command and has no special 
meaning elsewhere. You can turn off the special meaning of “&” by preceding it with a backslash “\’. Inputting 


s/ampersand/\&/ 


will convert the word “ampersand” into the literal symbol “&” in the current (dot) line. a) 


SUMMARY OF COMMANDS AND LINE NUMBERS 


The general form of the ed text editor commands is the command name, perhaps preceded by one or two 
line numbers. In the case of the edit command e, the read command r, and the write command w, the command 
name is also followed by a file name. Normally only one command is allowed to be entered per line, but a print 
command p may follow any other command (except for the edit command e, the read command r, the write com- 
mand w, and the quit command q). 


a Append adds lines to the buffer (at line dot, unless a different line is specified). Appending & 


ea? 


continues until a dot “.” is typed at the beginning (first character) of a newline. Dot is set 
to the last line appended. 
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Change the specified lines to the new text which follows. Entering newlines is terminated 
by a dot “.” as with‘a. If no lines are specified, the current line (dot) is replaced. Dot is 
set to last line changed. 


Delete the lines specified. If none are specified, delete line dot. Dot is set to the first 
undeleted line, unless $ is specified in which case dot is set to the last line, $. 


Edit new file. Any previous contents of the buffer are thrown away, so issue a write com- 
mand w beforehand. 


Print the remembered file name. If a name follows f, the remembered name will be set to 
it. 

The global command g/---/ecommands will execute the commands on those lines that con- 
tain “---”, 


“eo? 


Insert lines before the specified line or the current line (dot line) until a “.” is typed at the 
beginning of a newline. Dot is set to last line inserted. 


Move lines specified to after the line named after m. Dot is set to the last line moved. 


Print specified lines. If none specified, print line dot. A single line number is equivalent 
to “line number”. A single RETURN prints the next line, i.e., the dot plus one line, “.+1”. 


The quit command exits from ed. It wipes out all text in buffer if you give it twice in a 
row without first giving a write command w. 


Read a file into buffer (at end unless specified elsewhere). Dot set to last line read. If 
wr filename is used, the filename is read into the buffer immediately after the dot line. 


The substitute command s/string1/string2/ substitutes the characters “stringl” into 
“string2” in the specified lines. If no lines are specified, make the substitution in line dot. 
Dot is set to last line in which a substitution took place; if no substitution took place, dot 
is not changed. The command s changes only the first occurrence of “string1” on a line; 
to change all occurrences on a line, type a g after the final slash. 


The exclude command v/---/eommands executes commands only on those lines that do 
not contain “---”. 


The write command writes out the buffer contents onto a file. Dot is not changed. 


The “.=” causes the printout of the current line number. The dot value prints the line num- 
ber of the current line (dot line). The “=” by itself prints the value of the last line in the 
file. 


The “!” is a temporary escape command. The line ! command-line causes “command-line” 
to be executed as a UNIX operating system command while you are in the text editor. 


The context search command searches for next line which contains this string of charac- 
ters “----” and prints it. Dot is set to the line where string was found. Search starts at line 
“ =1” wraps around from the last line “$” to line “1” and continues to dot (the current line), 
if necessary. 


Performs context search in reverse direction. Starts search at the previous line “.—1”, 
scans to line 1, wraps around to the last line “$”, and scans back to the current line (dot 
line) if necessary. 
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NOTES 
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